This pull request improves the .github/workflows/build.yml CI workflow by adding detailed comments and clarifying configuration for building and deploying the site to GitHub Pages. The changes focus on making the workflow easier to understand and maintain by explaining each step and permission.

Workflow documentation and clarity:

• Added descriptive comments throughout the workflow to clarify the purpose of each section, job, and step, making it easier for future maintainers to understand the build and deploy process.

Configuration improvements:

• Clarified permissions required for GitHub Pages deployment and OIDC authentication by adding inline explanations for each permission entry.
• Documented concurrency settings to explain how overlapping deployments are avoided.
• Added comments to the Node.js setup and build steps to indicate alignment with project requirements and caching strategy.
• Provided explicit comments on conditional deployment steps to highlight when deployment actions are executed (only on pushes to main).